Clean up references to no-longer-existing APIs.
<xi:include href="xml/gdksurface.xml" />
<xi:include href="xml/gdktoplevel.xml" />
<xi:include href="xml/gdktoplevellayout.xml" />
+ <xi:include href="xml/gdktoplevelsize.xml" />
<xi:include href="xml/gdkpopup.xml" />
<xi:include href="xml/gdkpopuplayout.xml" />
<xi:include href="xml/gdkframeclock.xml" />
GdkAxisFlags
GdkDeviceTool
GdkDeviceToolType
-GdkDeviceType
<SUBSECTION>
gdk_device_get_name
<TITLE>Textures</TITLE>
<FILE>textures</FILE>
GdkTexture
+GdkMemoryTexture
+GdkGLTexture
gdk_texture_new_for_pixbuf
gdk_texture_new_from_resource
gdk_texture_new_from_file
gdk_x11_surface_get_desktop
gdk_x11_surface_set_utf8_property
gdk_x11_surface_set_frame_sync_enabled
+gdk_x11_surface_set_group
+gdk_x11_surface_get_group
gdk_x11_keymap_get_group_for_state
gdk_x11_keymap_key_is_modifier
gdk_x11_visual_get_xvisual
GDK_IS_CONTENT_DESERIALIZER
gdk_content_deserializer_get_type
</SECTION>
-
*
* Opens the default display specified by command line arguments or
* environment variables, sets it as the default display, and returns
- * it. gdk_parse_args() must have been called first. If the default
- * display has previously been set, simply returns that. An internal
- * function that should not be used by applications.
+ * it. If the default display has previously been set, simply returns
+ * that. An internal function that should not be used by applications.
*
* Returns: (nullable) (transfer none): the default display, if it
* could be opened, otherwise %NULL.
* @Title: Content Formats
* @Short_description: Advertising and negotiating of content
* exchange formats
- * @See_also: #GdkDragContext, #GdkClipboard, #GdkContentProvider
+ * @See_also: #GdkDrag, #GdkDrop, #GdkClipboard, #GdkContentProvider
*
* This section describes the #GdkContentFormats structure that is used to
* advertise and negotiate the format of content passed between different
* and gdk_device_pad_get_feature_group() can be combined to find out the
* number of buttons/rings/strips the device has, and how are they grouped.
*
- * Each of those groups have different modes, which may be used to map
- * each individual pad feature to multiple actions. Only one mode is
- * effective (current) for each given group, different groups may have
- * different current modes. The number of available modes in a group can
- * be found out through gdk_device_pad_get_group_n_modes(), and the current
- * mode for a given group will be notified through the #GdkEventPadGroupMode
- * event.
- *
+ * Each of those groups have different modes, which may be used to map each
+ * individual pad feature to multiple actions. Only one mode is effective
+ * (current) for each given group, different groups may have different
+ * current modes. The number of available modes in a group can be found
+ * out through gdk_device_pad_get_group_n_modes(), and the current mode for
+ * a given group will be notified through events of type #GDK_PAD_GROUP_MODE.
*/
/**
* gdk_display_get_default_seat() and gdk_display_list_seats().
*
* Output devices are represented by #GdkMonitor objects, which can be accessed
- * with gdk_display_get_monitor() and similar APIs.
+ * with gdk_display_get_monitor_at_surface() and similar APIs.
*/
/**
* Flushes any requests queued for the windowing system and waits until all
* requests have been handled. This is often used for making sure that the
* display is synchronized with the current state of the program. Calling
- * gdk_display_sync() before gdk_error_trap_pop() makes sure that any errors
- * generated from earlier requests are handled before the error trap is
- * removed.
+ * gdk_display_sync() before gdk_x11_display_error_trap_pop() makes sure
+ * that any errors generated from earlier requests are handled before the
+ * error trap is removed.
*
* This is most useful for X11. On windowing systems where requests are
* handled synchronously, this function will do nothing.
* provide appropriate display. Use gdk_display_is_composited()
* to check if that is the case.
*
- * For setting an overall opacity for a top-level surface, see
- * gdk_surface_set_opacity().
- *
* On modern displays, this value is always %TRUE.
*
* Returns: %TRUE if surfaces are created with an alpha channel or
* with multiple backends). Applications can use gdk_set_allowed_backends()
* to limit what backends can be used.
*
- * Returns: (transfer none): The global #GdkDisplayManager singleton;
- * gdk_parse_args(), gdk_init(), or gdk_init_check() must have
- * been called first.
+ * Returns: (transfer none): The global #GdkDisplayManager singleton
**/
GdkDisplayManager*
gdk_display_manager_get (void)
* Possible drop sites get informed about the status of the ongoing drag operation
* with events of type %GDK_DRAG_ENTER, %GDK_DRAG_LEAVE, %GDK_DRAG_MOTION and
* %GDK_DROP_START. The #GdkDrop object can be obtained from these #GdkEvents
- * using gdk_event_get_drop().
+ * using gdk_dnd_event_get_drop().
*
* The actual data transfer is initiated from the target side via an async
* read, using one of the GdkDrop functions for this purpose: gdk_drop_read_async()
* returns %FALSE for the result - gdk_drop_finish() must choose
* the action to use when accepting the drop. This will only
* happen if you passed %GDK_ACTION_ASK as one of the possible
- * actions in gdk_drag_status(). %GDK_ACTION_ASK itself will not
+ * actions in gdk_drop_status(). %GDK_ACTION_ASK itself will not
* be included in the actions returned by this function.
*
* This value may change over the lifetime of the #GdkDrop both
* gdk_event_triggers_context_menu:
* @event: a #GdkEvent, currently only button events are meaningful values
*
- * This function returns whether a #GdkEventButton should trigger a
- * context menu, according to platform conventions. The right mouse
- * button always triggers context menus.
+ * This function returns whether a #GdkEvent should trigger a
+ * context menu, according to platform conventions. The right
+ * mouse button always triggers context menus.
*
* This function should always be used instead of simply checking for
* event->button == %GDK_BUTTON_SECONDARY.
* @GDK_SCROLL_LEFT: the surface is scrolled to the left.
* @GDK_SCROLL_RIGHT: the surface is scrolled to the right.
* @GDK_SCROLL_SMOOTH: the scrolling is determined by the delta values
- * in scroll events. See gdk_event_get_scroll_deltas()
+ * in scroll events. See gdk_scroll_event_get_deltas()
*
* Specifies the direction for scroll events.
*/
* This signal is emitted as the third step of toolkit and
* application processing of the frame. The frame is
* repainted. GDK normally handles this internally and
- * produces expose events, which are turned into GTK
- * #GtkWidget::draw signals.
+ * emits #GdkSurface::render which are turned into
+ * #GtkWidget::snapshot signals by GTK.
*/
signals[PAINT] =
g_signal_new (g_intern_static_string ("paint"),
* A #GdkPaintable may change its contents, meaning that it will now produce a
* different output with the same snpashot. Once that happens, it will call
* gdk_paintable_invalidate_contents() which will emit the
- * #GdkPaintable::invalidate-contents signal.
- * If a paintable is known to never change its contents, it will set the
- * %GDK_PAINTABLE_STATIC_CONTENTS flag. If a consumer cannot deal with changing
- * contents, it may call gdk_paintable_get_static_image() which will return a
- * static paintable and use that.
+ * #GdkPaintable::invalidate-contents signal. If a paintable is known to never
+ * change its contents, it will set the %GDK_PAINTABLE_STATIC_CONTENTS flag.
+ * If a consumer cannot deal with changing contents, it may call
+ * gdk_paintable_get_current_image() which will return a static paintable and
+ * use that.
*
* A paintable can report an intrinsic (or preferred) size or aspect ratio it
* wishes to be rendered at, though it doesn't have to. Consumers of the interface
* @rect_anchor: the point on @anchor_rect to align with @surface's anchor point
* @surface_anchor: the point on @surface to align with @rect's anchor point
*
- * Create a popup layout description. Used together with
- * gdk_surface_present_popup() to describe how a popup surface should be placed
- * and behave on-screen.
+ * Create a popup layout description. Used together with gdk_popup_present()
+ * to describe how a popup surface should be placed and behave on-screen.
*
* @anchor_rect is relative to the top-left corner of the surface's parent.
- * @rect_anchor and @surface_anchor determine anchor points on @anchor_rect and
- * surface to pin together.
+ * @rect_anchor and @surface_anchor determine anchor points on @anchor_rect
+ * and surface to pin together.
*
* The position of @anchor_rect's anchor point can optionally be offset using
* gdk_popup_layout_set_offset(), which is equivalent to offsetting the
*
* Create a new popup surface.
*
- * The surface will be attached to @parent and can be positioned relative to it
- * using gdk_surface_show_popup() or later using gdk_surface_layout_popup().
+ * The surface will be attached to @parent and can be positioned
+ * relative to it using gdk_popup_present().
*
* Returns: (transfer full): a new #GdkSurface
*/
* gdk_surface_get_mapped:
* @surface: a #GdkSurface
*
- * Checks whether the surface has been mapped (with gdk_surface_show() or
- * gdk_surface_show_unraised()).
+ * Checks whether the surface has been mapped (with gdk_toplevel_present()
+ * or gdk_popup_present()).
*
* Returns: %TRUE if the surface is mapped
**/
* and the input region controls where the surface is
* “clickable”.
*
- * Use gdk_display_support_input_shapes() to find out if
+ * Use gdk_display_supports_input_shapes() to find out if
* a particular backend supports input regions.
*/
void
*
* The startup ID is also what is used to signal that the startup is
* complete (for example, when opening a window or when calling
- * gdk_notify_startup_complete()).
+ * gdk_display_notify_startup_complete()).
**/
void
gdk_wayland_display_set_startup_notification_id (GdkDisplay *display,
* should be taken.
*
* If the windowing system supports it, existing cursors created
- * with gdk_cursor_new(), gdk_cursor_new_for_display() and
- * gdk_cursor_new_from_name() are updated to reflect the theme
- * change. Custom cursors constructed with
- * gdk_cursor_new_from_texture() will have to be handled
- * by the application (GTK+ applications can learn about
- * cursor theme changes by listening for change notification
+ * with gdk_cursor_new_from_name() are updated to reflect the theme
+ * change. Custom cursors constructed with gdk_cursor_new_from_texture()
+ * will have to be handled by the application (GTK applications can
+ * learn about cursor theme changes by listening for change notification
* for the corresponding #GtkSetting).
*/
void
* should be taken.
*
* If the windowing system supports it, existing cursors created
- * with gdk_cursor_new(), gdk_cursor_new_for_display() and
- * gdk_cursor_new_from_name() are updated to reflect the theme
- * change. Custom cursors constructed with
- * gdk_cursor_new_from_texture() will have to be handled
- * by the application (GTK+ applications can learn about
- * cursor theme changes by listening for change notification
+ * with gdk_cursor_new_from_name() are updated to reflect the theme
+ * change. Custom cursors constructed with gdk_cursor_new_from_texture()
+ * will have to be handled by the application (GTK applications can learn
+ * about cursor theme changes by listening for change notification
* for the corresponding #GtkSetting).
*/
void
*
* Returns the default group leader surface for all toplevel surfaces
* on @display. This surface is implicitly created by GDK.
- * See gdk_surface_set_group().
+ * See gdk_x11_surface_set_group().
*
* Returns: (transfer none): The default group leader surface
* for @display
*
* The startup ID is also what is used to signal that the startup is
* complete (for example, when opening a window or when calling
- * gdk_notify_startup_complete()).
+ * gdk_display_notify_startup_complete()).
**/
void
gdk_x11_display_set_startup_notification_id (GdkDisplay *display,
* the application. Use gdk_x11_display_error_trap_pop() or
* gdk_x11_display_error_trap_pop_ignored()to lift a trap pushed
* with this function.
- *
- * See also gdk_error_trap_push() to push a trap on all displays.
*/
void
gdk_x11_display_error_trap_push (GdkDisplay *display)
* If you don’t need to use the return value,
* gdk_x11_display_error_trap_pop_ignored() would be more efficient.
*
- * See gdk_error_trap_pop() for the all-displays-at-once
- * equivalent.
- *
* Returns: X error code or 0 on success
*/
int
* Does not block to see if an error occurred; merely records the
* range of requests to ignore errors for, and ignores those errors
* if they arrive asynchronously.
- *
- * See gdk_error_trap_pop_ignored() for the all-displays-at-once
- * equivalent.
*/
void
gdk_x11_display_error_trap_pop_ignored (GdkDisplay *display)
/**
* gdk_x11_monitor_get_output:
* @monitor: (type GdkX11Monitor): a #GdkMonitor
+ *
+ * Returns the XID of the Output corresponding to @monitor.
+ *
+ * Returns: the XID of @monitor
*/
XID
gdk_x11_monitor_get_output (GdkMonitor *monitor)
* @length: The number of items to transform
* @list: location to store an array of strings in
* the encoding of the current locale. This array should be
- * freed using gdk_free_text_list().
+ * freed using gdk_x11_free_text_list().
*
* Convert a text string from the encoding as it is stored
* in a property into an array of strings in the encoding of
projects / gtk4.git / commitdiff